home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 July / EnigmA AMIGA RUN 29 (1998)(G.R. Edizioni)(IT)[!][issue 1998-07 & 08].iso / cd-sup / cdrom / makecd_3.0 / goodies / nsdpatch / nsdpatch.cfg < prev    next >
Text File  |  1998-05-24  |  19KB  |  391 lines
  1. #
  2. # $Id: NSDPatch.cfg 1.14 1997/08/26 10:34:15 heinz Exp $
  3. # $VER: NSDPatch.cfg 43.1 (28.2.97)
  4. #
  5. # Demonstration patch configuration file for NSDPatch
  6. # ===================================================
  7. #
  8. #
  9. # Each device patch configuration must reside on a single line.
  10. # A patch that has been installed once cannot be changed.
  11. # The patching process works also for devices which generate a
  12. # new device base for each OpenDevice() call. It is not Unit
  13. # specific. For devices generating multiple bases per OpenDevice(),
  14. # existing opens won't be patched as they can't be located.
  15. # Once a patch is installed any Unit opened since then will be
  16. # patched.
  17. #
  18. # NOTE WELL: A device patch is not meant to replace an NSD upgrade
  19. #            forever. It will emulate NSD device behaviour on top
  20. #            of existing devices fairly well. It will not add any
  21. #            major safety checks or automagically fix every problem
  22. #            you might have with an old Exec device. It may not
  23. #            implement every single NSD detail for various device
  24. #            types.
  25. #
  26. # THERE IS ABSOLUTELY NO WARRANTY WHATSOEVER! STANDARD DISCLAIMER!
  27. #
  28. # How to install the patch:
  29. #
  30. #   1. Copy the configuration file and NSDPatch onto your boot
  31. #      partition.  You can choose the place arbitrarily, though DEVS:
  32. #      and C: are recommended respectively.
  33. #
  34. #   2. If needed, rename the configuration file and change it as
  35. #      needed for your setup. Check the option descriptions below.
  36. #      BE CAREFUL WHEN CHOOSING PATCH OPTIONS!
  37. #
  38. #   3. Add a line like this one *immediately* after SetPatch to your
  39. #      S:Startup-Sequence:
  40. #
  41. #           <location>NSDPatch PCF <configfile>
  42. #
  43. #   4. On every subsequent reboot, the NSDPatch will silently be
  44. #      turned on according to the configuration. There is nothing
  45. #      more you have to do except turning off the patch for any device
  46. #      that gets updated to be NSD compliant.
  47.  
  48. #
  49. # There are various options, parsed in dos.library/ReadArgs() style.
  50. # This file describes the options available with NSDPatch 43.5.
  51. #
  52.  
  53. #  DEVICE       The name of the device to patch (need not be resident)
  54. #               If your device supports NSD already, it usually is
  55. #               *NOT* wise to patch it!
  56.  
  57. #  COMMANDS     A comma separated list of the supported command
  58. #               numbers. It is not necessary to specify the general
  59. #               NSD commands like NSCMD_DEVICEQUERY.
  60. #               After specifying commands, you can exclude them with
  61. #               a subsequent negative specification as shown below.
  62. #               Just use the "!" character to specify a command number
  63. #               or range to be subsequently excluded again.
  64. #               (Needs "DEVICE" option)
  65.  
  66. #  DEVICETYPE   The numeric or symbolic NSD device type to set
  67. #               (Needs "COMMANDS" option)
  68.  
  69. #  IOERRNOCMD/S If the device to patch does not support IOERR_NOCMD
  70. #               correctly, i.e. if it crashes on unknown commands,
  71. #               specify this option. Only the commands specified
  72. #               via the "COMMANDS" option will be accepted then.
  73. #               All other requests will be safely returned with the
  74. #               IOERR_NOCMD error.
  75. #               (Needs "DEVICETYPE" option)
  76.  
  77. #  TD64/S       If the device to be patched supports the TD64 command
  78. #               set, use this option. The NSD trackdisk extensions will
  79. #               automatically be redirected then to make use of that
  80. #               functionality for e.g. the V43 FastFileSystem.
  81. #               Otherwise a simple HD_SCSICMD fallback is implemented
  82. #               for trackdisk like devices. This fallback is _very_
  83. #               simple to emulate 64 bit commands. Don't expect magic.
  84. #               (Needs "DEVICETYPE" option)
  85.  
  86. #  ACTIVATE     A DOS pattern to tell which DOS device names should
  87. #               be activated to e.g. start up a filesystem on a
  88. #               patched device. It is safe to specify already
  89. #               active devices. Devices where the name is "hidden"
  90. #               by a volume of the same name currently won't be
  91. #               activated. You may want to specify the partition
  92. #               names of partitions exceeding the 4GB barrier here
  93. #               for a patched device with the V43 FastFileSystem.
  94.  
  95. #  RDBUNIT/N    If you have a trackdisk like boot device that
  96. #               crashes on unknown commands instead of returning
  97. #               IOERR_NOCMD, you will need this option,
  98. #               "IOERRNOCMD", and "ACTIVATE". You can't boot from a
  99. #               partition exceeding the 4GB barrier with an old
  100. #               style device and the V43 FastFileSystem, and you
  101. #               must not mark any partitions exceeding that barrier
  102. #               as automountable if you have a device that does not
  103. #               support IOERR_NOCMD. These partitions won't be
  104. #               activated automatically by e.g. V43 FFS until the
  105. #               patch is installed. To activate or mount these
  106. #               partitions automatically after the patch is in
  107. #               place, specify the device unit number to scan here
  108. #               and the partition names with the "ACTIVATE" option.
  109. #               The Rigid Disk Block on the named unit will be
  110. #               scanned and all named partitions will be mounted.
  111. #               If you specify partitions that are already
  112. #               mounted, an error will be returned. Actually, this
  113. #               option is useful as a general "late mount"
  114. #               functionality! Note that this only looks for
  115. #               partitions that are not marked as auto mountable!
  116.  
  117. #  MOUNTANY/S   To force RDBUNIT to look at any partition entry within
  118. #               the RDB, you can use this option. NSDPatch is a general
  119. #               "late" mount tool then, suitable for any partitions.
  120. #
  121.  
  122. #  VERSION/N    If you know the exact version of a certain device to
  123. #  REVISION/N   be patched, specify these options. The patch line
  124. #               will only be used if this version and revision
  125. #               can be found. As NSDPatch will not skip configuration
  126. #               lines for already patched devices, you can make a list
  127. #               of certain patches for specific versions, followed by
  128. #               a "generic" line for all other versions.
  129. #               This is shown below for scsi.device.
  130. #               Note the usefulness for these options with the ISNSD
  131. #               and VERSIONISNSD options!
  132. #
  133. #               Patches with version and revision info always take
  134. #               precedence over a general patch line for the same
  135. #               deviceif they apply.
  136.  
  137. #  SANA2MAGIC/S Some SANA2 devices don't take it very well if they
  138. #               get passed a NULL buffer management pointer on OpenDevice()
  139. #               This not only makes it hard for NSD to operate nicely, it
  140. #               also confuses some of the popular SANA2 debugging tools.
  141. #               If you have a device like this, you may want to try this
  142. #               option. It should help by providing a dummy pointer if needed.
  143.  
  144. #  ISNSD/S      Will recognize and not patch any device with at least
  145. #               the given VERSION and, optionally,  REVISION.
  146.  
  147. #  VERSIONISNSD/S   Works like ISNSD for the exact VERSION.REVISION.
  148. #               This is useful in case somebody put out a non NSD
  149. #               device suddenly with a higher version number. Tss.
  150. #               What an idea.
  151.  
  152. #  SINGLEPATCHONLY/S
  153. #               NSDPatch will patch a device just once on the "first" call
  154. #               to OpenDevice(). This option is still accepted, but OBSOLETE,
  155. #               as this behaviour is NSDPatch default starting with NSDPatch
  156. #               version 43.12.
  157. #
  158.  
  159. #  TRYMULTIPATCH/S
  160. #               Normally, NSDPatch will check a device to patch on
  161. #               the initial OpenDevice() call and patch it
  162. #               appropriately. This behaviour is default starting
  163. #               with NSDPatch 43.12. If you encounter a device that
  164. #               changes its own device function addresses while it
  165. #               is open, you should use this option. This is highly
  166. #               unlikely, though, as this behaviour would be rather
  167. #               inefficient and possibly crash prone. Note
  168. #               that when using this option, you may encounter
  169. #               infinite loops if other tools like debuggers
  170. #               also patch into the device vectors. Before 43.12,
  171. #               this option was the default setting but due to its
  172. #               dangerous nature, SINGLEPATCHONLY is now the
  173. #               default setting.
  174.  
  175. #
  176. #  MAPTODEVICE/K
  177. #  MAPTOUNIT/K/N
  178. #               By using this type, you can define mappings from one
  179. #               device/unit combination to another. This is
  180. #               useful if special tools check on the device
  181. #               name for certain functionality and you really want
  182. #               to use another device/unit. Examples can be found
  183. #               below. It is usually unwise to map devices to
  184. #               devices of a different type because the command
  185. #               sets may well differ in a way that confuse non NSD
  186. #               aware applications. Note that mapping trackdisk
  187. #               units to other devices may be dangerous unless you
  188. #               run any "noclick" hack before NSDPatch!
  189. #
  190.  
  191. #
  192. #  FIXSCSIUPDATE/S
  193. #               The V40 scsi.device has a problem with the JAZ-drive
  194. #               A CMD_UPDATE will start up the drive even if there is
  195. #               nothing to update. For any trackdisk like device
  196. #               with HD_SCSICMD, you # can specify this option to
  197. #               fix a JAZ-drive. CMD_UPDATE will be replaced then
  198. #               with a safe version, which only syncs up the
  199. #               drive's caches if the drive is ready.
  200. #
  201.  
  202. #-------------------------------------------------------------------------
  203. #
  204. # Default configuration lines for the V40 (OS 3.1) devices.
  205. # If you find any bugs or omissions, please report them.
  206. # With some work, all the correct versions could be added,
  207. # and this file could contain complete patch information for
  208. # different OS versions. Feedback on this is welcome.
  209.  
  210. #
  211. # Add a comment '#' character to those lines where you already
  212. # use a NSD device.
  213. #
  214.  
  215. # Notes:
  216. #
  217. #   - audio.device is marked with IOERRNOCMD. It does not crash on
  218. #     unknown commands, but it doesn't set IOERR_NOCMD correctly.
  219. #
  220. #   - As a convenience measure for A4000T users, a line with
  221. #     2nd.scsi.device, equal to the scsi.device line, has been added.
  222. #
  223. #   - mfm.device V38/V40 trashes a CPU register on OpenDevice() and
  224. #     has a special private configuration command. The patch fixes
  225. #     the former automagically (as for any device), and the patch
  226. #     line reflects the latter.
  227. #
  228. #   - scsi.device V40 and before V43.22 will not handle CMD_UPDATE well,
  229. #     This is worked around by the FIXSCSIUPDATE option in the respective
  230. #     lines.
  231.  
  232. DEVICE audio.device     DEVICETYPE NSDEVTYPE_AUDIO      COMMANDS 1-14,32 IOERRNOCMD
  233. DEVICE cd.device        DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,18-23,32-46
  234. DEVICE clipboard.device DEVICETYPE NSDEVTYPE_CLIPBOARD  COMMANDS 2-4,9-12
  235. DEVICE console.device   DEVICETYPE NSDEVTYPE_CONSOLE    COMMANDS 1-3,9-12
  236. DEVICE gameport.device  DEVICETYPE NSDEVTYPE_GAMEPORT   COMMANDS 1,5-13
  237. DEVICE input.device     DEVICETYPE NSDEVTYPE_INPUT      COMMANDS 1,5-16
  238. DEVICE keyboard.device  DEVICETYPE NSDEVTYPE_KEYBOARD   COMMANDS 1,5-13
  239. DEVICE parallel.device  DEVICETYPE NSDEVTYPE_PARALLEL   COMMANDS 1-10
  240. DEVICE printer.device   DEVICETYPE NSDEVTYPE_PRINTER    COMMANDS 1-12,!2,!4,!5
  241. DEVICE ramdrive.device  DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 2-5,9,11-15
  242. DEVICE scsi.device      DEVICETYPE NSDEVTYPE_TRACKDISK  VERSION 43 ISNSD
  243. DEVICE scsi.device      DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28 VERSION 40 REVISION 20 FIXSCSIUPDATE
  244. DEVICE scsi.device      DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28,!22 FIXSCSIUPDATE
  245. DEVICE 2nd.scsi.device  DEVICETYPE NSDEVTYPE_TRACKDISK  VERSION 43 ISNSD
  246. DEVICE 2nd.scsi.device  DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28 VERSION 40 REVISION 20 FIXSCSIUPDATE
  247. DEVICE 2nd.scsi.device  DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28,!22 FIXSCSIUPDATE
  248. DEVICE serial.device    DEVICETYPE NSDEVTYPE_SERIAL     COMMANDS 1-11,!4
  249. DEVICE timer.device     DEVICETYPE NSDEVTYPE_TIMER      COMMANDS 9-11
  250. DEVICE trackdisk.device DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 2-16,!8,$8002-$8005,$8009-$800b,$8010-$8011
  251. DEVICE mfm.device       DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-23,29
  252.  
  253. DEVICE a2065.device     DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26 SANA2MAGIC
  254. DEVICE a2060.device     DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,17-26 SANA2MAGIC IOERRNOCMD
  255. DEVICE slip.device      DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,9-26
  256.  
  257. #-------------------------------------------------------------------------
  258. #
  259. # A few configuration lines for known third party stuff. Please report
  260. # more device configurations if you can obtain them!
  261. #
  262. # It is unwise to use a configuration line without checking the version
  263. # of the device first! Not all these entries are necessarily tested.
  264. #
  265. # Entries for devices that are known to be troublesome are enabled as
  266. # default.
  267. #
  268. # Entries for specific known versions precede entries that should cover
  269. # all other versions.
  270. #
  271. # If you create new entries here, please report them to
  272. # <heinz@hwg.muc.de>. Thanks a lot.
  273. #
  274.  
  275. # For omniscsi.device 1.9 as used in some Guru-ROM's
  276. # Yes, to patch omniscsi.device, you'll need the name gvpscsi.device!
  277. #DEVICE gvpscsi.device   DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 2-5,9-15,20-23,28
  278.  
  279. # For HardFrame Controllers
  280. #DEVICE HardFrame.device DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,23,28
  281.  
  282. # Oliver Kastl's atapi.device
  283. #DEVICE atapi.device      DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28
  284.  
  285. # Another recoverable ram disk
  286. DEVICE statram.device    DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 2-15,20-21 VERSION 37 REVISION 11
  287.  
  288. # For Hardital Synthesis Controllers
  289. # Looks like this should work with syndisk.device 33.x
  290. DEVICE syndisk.device    DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 2-5,9,11-15,28,$69,$6d,$70,$73
  291.  
  292. DEVICE amoksana.device   DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 1-5,8-9,16-26 VERSION 3 REVISION 189 SANA2MAGIC
  293. DEVICE amoksana.device   DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 1-5,8-9,16-26 VERSION 3 REVISION 190 SANA2MAGIC
  294. DEVICE amoksana.device   DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 1-5,8-9,16-26 SANA2MAGIC
  295.  
  296. # VillageTronic Ariadne board.
  297. #DEVICE ariadne.device    DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26 VERSION 1 REVISION 39
  298. #DEVICE ariadne.device    DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26
  299.  
  300. # Interworks ICard
  301. DEVICE icard.device      DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26 VERSION 1 REVISION 4 SANA2MAGIC IOERRNOCMD
  302. DEVICE icard.device      DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26 SANA2MAGIC IOERRNOCMD
  303.  
  304. # NE2000 for the GoldenGate board
  305. DEVICE gg_ne2000.device  DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26 VERSION 37 REVISION 7 SANA2MAGIC
  306. DEVICE gg_ne2000.device  DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-26 SANA2MAGIC
  307.  
  308. # QuickNet board
  309. DEVICE QuickNetS2.device DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,17-26,$7ff0 VERSION 2 REVISION 3 SANA2MAGIC IOERRNOCMD
  310. DEVICE QuickNetS2.device DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,17-26,$7ff0 SANA2MAGIC IOERRNOCMD
  311. DEVICE QuickNet.device   DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8,17,20 SANA2MAGIC
  312.  
  313. # Holger Kruse
  314. #DEVICE ppp.device        DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,9-11,14-26
  315.  
  316. # A4066
  317. #DEVICE a4066.device      DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,9-11,14-26 VERSION 1 REVISION 9
  318.  
  319. # Hydra
  320. DEVICE hydra.device      DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-27 VERSION 1 REVISION 44 SANA2MAGIC
  321. DEVICE hydra.device      DEVICETYPE NSDEVTYPE_SANA2      COMMANDS 2-3,8-11,14-27 SANA2MAGIC
  322.  
  323. # A few lines donated by Alessandro Zummo
  324. # MultiFace Card
  325. #DEVICE duart.device      DEVICETYPE NSDEVTYPE_SERIAL     COMMANDS 1-11,!4
  326. #DEVICE pit.device        DEVICETYPE NSDEVTYPE_PARALLEL   COMMANDS 1-10
  327. # GVP IOExtender or GForce 040 Combo
  328. #DEVICE gvppar.device     DEVICETYPE NSDEVTYPE_PARALLEL   COMMANDS 1-10
  329. #DEVICE gvpser.device     DEVICETYPE NSDEVTYPE_SERIAL     COMMANDS 1-11,!4
  330. # Blizzard boards from Phase V
  331. #DEVICE 2060scsi.device   DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28
  332. #DEVICE 1260scsi.device   DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28
  333. #DEVICE 1230scsi.device   DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-15,20-23,28
  334. # diskserial.device
  335. #DEVICE diskserial.device  DEVICETYPE NSDEVTYPE_SERIAL     COMMANDS 1-11,!4
  336. # a2232.device
  337. #DEVICE a2232.device       DEVICETYPE NSDEVTYPE_SERIAL     COMMANDS 1-11,!4
  338.  
  339. # HWG version 40.9
  340. DEVICE a2060.device     DEVICETYPE NSDEVTYPE_SANA2      VERSION 40 REVISION 9 ISNSD
  341.  
  342. # HWG/MBS version 3.x
  343. DEVICE a2065.device     DEVICETYPE NSDEVTYPE_SANA2      VERSION 3 ISNSD
  344.  
  345. # This should cover SCSI/IDE users with a DataFlyer card.
  346. DEVICE ExpSys.device    DEVICETYPE NSDEVTYPE_TRACKDISK  COMMANDS 1-9,11-15,18,20-22,28-29 IOERRNOCMD
  347.  
  348. #-------------------------------------------------------------------------
  349. #
  350. # Some broken software checks the device name and assumes certain
  351. # capabilities. This prohibits the use of updated drivers because
  352. # the software would not use their features.
  353. # Via device mapping, you can map a certain device unit combination
  354. # to another.
  355. #
  356.  
  357. # Fool CrossDOS into using TD_GETGEOMETRY for fake units
  358. #DEVICE mfm.device       UNIT 1 MAPTODEVICE hwgatapi.device MAPTOUNIT 1
  359. #DEVICE mfm.device       UNIT 1 MAPTODEVICE scsi.device MAPTOUNIT 1
  360. # Same thing for versions of FFS.
  361. # Note that mapping trackdisk units to other devices may be dangerous
  362. # unless you run any noclick hack before NSDPatch!
  363. #DEVICE trackdisk.device UNIT 1 MAPTODEVICE hwgatapi.device MAPTOUNIT 1
  364. #DEVICE trackdisk.device UNIT 1 MAPTODEVICE scsi.device MAPTOUNIT 1
  365.  
  366.  
  367. #-------------------------------------------------------------------------
  368. #
  369. # Demonstration lines for activation and late mount functionality.
  370. # If you want to late mount huge partitions, place the late mount lines
  371. # after the device patch line. Note that you must not specify a colon
  372. # for the DOS names.
  373. #
  374.  
  375. # Activate a mounted DOS device entry named "HUGE" (without the colon!)
  376. #ACTIVATE HUGE
  377.  
  378. # Late-Mount and activate a partition named "BIG" on scsi.device unit 4
  379. #DEVICE scsi.device RDBUNIT 4 ACTIVATE BIG
  380.  
  381. # Late-Mount all unmounted partitions on scsi.device unit 4
  382. #DEVICE scsi.device RDBUNIT 4 ACTIVATE #?
  383.  
  384. # Late-Mount all unmounted partitions except for UNIX and MAC on scsi.device unit 4
  385. #DEVICE scsi.device RDBUNIT 4 ACTIVATE ~(UNIX|MAC)
  386.  
  387. #-------------------------------------------------------------------------
  388.  
  389. ### EOT ###
  390.  
  391.